package com.td.module.pests.service.library;

import com.td.framework.common.pojo.PageResult;
import com.td.module.pests.controller.admin.library.vo.LibraryCreateReqVO;
import com.td.module.pests.controller.admin.library.vo.LibraryExportReqVO;
import com.td.module.pests.controller.admin.library.vo.LibraryPageReqVO;
import com.td.module.pests.controller.admin.library.vo.LibraryUpdateReqVO;
import com.td.module.pests.dal.dataobject.library.LibraryDO;

import javax.validation.Valid;
import java.util.Collection;
import java.util.List;

/**
 * 病虫害知识库 Service 接口
 *
 * @author wangxx
 */
public interface LibraryService {

    /**
     * 创建病虫害知识库
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createLibrary(@Valid LibraryCreateReqVO createReqVO);

    /**
     * 更新病虫害知识库
     *
     * @param updateReqVO 更新信息
     */
    void updateLibrary(@Valid LibraryUpdateReqVO updateReqVO);

    /**
     * 删除病虫害知识库
     *
     * @param id 编号
     */
    void deleteLibrary(Long id);

    /**
     * 获得病虫害知识库
     *
     * @param id 编号
     * @return 病虫害知识库
     */
    LibraryDO getLibrary(Long id);

    /**
     * 获得病虫害知识库列表
     *
     * @param ids 编号
     * @return 病虫害知识库列表
     */
    List<LibraryDO> getLibraryList(Collection<Long> ids);

    /**
     * 获得病虫害知识库分页
     *
     * @param pageReqVO 分页查询
     * @return 病虫害知识库分页
     */
    PageResult<LibraryDO> getLibraryPage(LibraryPageReqVO pageReqVO);

    /**
     * 获得病虫害知识库列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 病虫害知识库列表
     */
    List<LibraryDO> getLibraryList(LibraryExportReqVO exportReqVO);

}
